If you have the PrDK 4.10, a more recent
explanation is available page Target / Startup parameters.
Basically ISaGRAF target applications (IsaVM, IsaCMG, IsaIXD,...
) and IsaIXL library (through any client application) need to be
configured at startup for several purposes. For example the CMG
needs the maximum number of resources that can be launched. Usually
these parameters are only used at application start-up. Default
values are provided when nothing special is done to set these
parameters.
A parameter name is defined by:
The application name using it.
A component name (ex: KVBETCP for Tcp/Ip binding driver) if the
parameter is not proper to the application itself but comes from a
component (I/O, Binding, IXL,...). This allows these components to
get parameters without any conflict.
The slave number for the virtual machine application if
required.
The parameter name itself.
A parameter can have a list of one or more values.
The method for passing these parameters depends on the system
and on the application type.
For ISaGRAF target applications it is linked to the dsys0arg.c
file implementation in the system layer. The implementation
provided by default manages the command line as follows:
Parameters begin with a '-'
Component name, if any, is suffixed to the parameter name with
a '\' separator.
An '=' separator is used just between the parameter name and
the parameter value.
If a list of values is required, they are separated with a ','
character.
When values include spaces, depending on the system, the whole
"parameter=value(s)" may be enclosed by " characters.
Ex: -ResNbr=20
or -s=2,5,6
or -HSD\RcvMaxMsg=10
For ISaGRAF target applications under Windows NT these
parameters can also be set in an ini file.
The ini file name is "applicationName".ini. Ex:
ISaGRAF.ini
Parameters without component name are set in [APP]
section.
Parameters with component name are set in the section named as
the component name. Ex: [HSD].
For virtual machines, the section can be prefixed with the
slave number (decimal) in order to distinguish different virtual
machines setting values. In that case, the parameter is first
searched in the suffixed section if it exists. If not found it is
searched in the non suffixed section.
Ex: ISaGRAF.ini
[APP]
ResNbr=20
s=2,5,6
or IsaVM.ini
[APP]
RtnRead=0
[SRV]
MaxScan=8
[SRV12]; Here '12' is the VM number 12 in decimal
MaxScan=3
For ISaGRAF target applications under VxWorks and OS-9 these
parameters can also be set through environnement variables using
putEnv() function for VxWorks and setenv() function for OS-9.
Parameter syntax is : APP[_CMPT][_No0x....]_ABCD.. with:
Upper case.
APP = Application name (ISACMG, ISAIXD, ISAVM,...).
CMPT = Component name if any.
No0x = Slave number if any in hexadecimal (for
ISAVM).
ABCD = Parameter name.
Ex: putEnv("ISAVM_RTNREAD=0")
putEnv("ISAVM_SRV_MAXSCAN=8")
putEnv("ISAVM_SRV_000B_MAXSCAN=3")
For client applications using IXL, it is defined by the given
function for parameter extraction passed in "pfnParamExtract"
argument of the ixlInit() function. The way of retreiving
parameters by ISaGRAF target applications on the plateform can be
used by passing dsysArgGet() routine. Note that in this case to
allow command line management, the following function must be
called before ixlInit():